home *** CD-ROM | disk | FTP | other *** search
/ Internet Magazine 2002 June / INTERNET92.ISO / pc / software / windows / utils / mysql_studio / winstudio_setup.exe / {app} / myodbc / README.win < prev    next >
Encoding:
Text File  |  2002-01-31  |  7.8 KB  |  163 lines
  1. This is the source or binary distribution of ODBC for MySQL.
  2. This software is in public domain. You may use it in any way you like.
  3. There is no WARRANTY of any kind. Use at our own risk..
  4.  
  5. If you want to ensure the development of this product, you should register
  6. for MySQL support and tell that you are using MyODBC in the comment field!
  7.  
  8. The setup32 binary distribution may be obtained from the file myodbc-xxx.zip
  9. at http://www.mysql.com/
  10.  
  11. To get all functionality from the ODBC driver (like transaction
  12. support) you should use it against MySQL 3.23.36 or above. This driver
  13. also works with MySQL 3.20.x
  14.  
  15. To compile with Microsoft VC++ one will need the ODBC 3.0 package from
  16. Microsoft or VC++ 5.0 or 6.0 professional edition.  This version of
  17. MyODBC is made with VC++ 6.0, with a define to force ODBC 2.50 usage,
  18. together with the installer from ODBC 2.5.  You will also need the
  19. MySQL libraries and header files from MySQL 3.23.36 or newer.
  20.  
  21. We will look into the 3.0 ODBC kit when we can get the installer
  22. problem solved.  We may be able to fool the setup program by using a
  23. 2.5 installer with a ODBC 3.0 driver, but we have to investigate this
  24. at some later time.
  25.  
  26. In the source distribution the example makefiles and resources are made
  27. with VC++ 6.0.
  28.  
  29. If you have problems installing MyODBC the most likely problem is that
  30. you have some applications running that uses the ODBC manager. The
  31. solution to this is to start your computer in 'safe mode' and install
  32. MyODBC in this mode.  Another option is to try the small installer
  33. (install.bat) that comes with the myodbc-xxxx-dll.zip distribution.
  34.  
  35.  
  36. HOW TO MAKE A PROPER BUG REPORT:
  37.  
  38. To make a bug report that will be answered quickly do the following:
  39. Put a 4 in the Option argument.  This will tell MyODBC to make a trace
  40. file in C:\myodbc.log that contains lot of info with will help us to
  41. debug the problem.  One can also set the MYSQL_DEBUG environment variable
  42. to something like 'd:t:O,c::\tmp\mysql.log' to get a log in C:\tmp\mysql.log
  43.  
  44. A sql.log file, with may be enabled with odbcadmin from the Control Panel,
  45. could also provide some interesting info. If possible try to get a log
  46. from the mysqld server too.
  47.  
  48.  
  49. IMPORTANT NOTES:
  50.  
  51.   MyODBC 2.50.18 has a new nice interface to the different MyODBC options.
  52.   (On Unix the option is still a number).
  53.  
  54.   The Option argument is used to tell MyODBC that the client isn't 100% ODBC
  55.   compliant. The following options are listed in the same order as they
  56.   appear in the MyODBC connect screen:
  57.  
  58.   1   The client can't handle that MyODBC returns the real width of a column.
  59.   2   The client can't handle that MySQL returns the true value of
  60.       affected rows.  If this flag is set then MySQL returns 'found rows'
  61.       instead.  One must have MySQL 3.21.14 or newer to get this to work.
  62.   4   Make a debug log in c:\myodbc.log.  This is the same as putting
  63.       MYSQL_DEBUG=d:t:O,c::\myodbc.log in AUTOEXEC.BAT
  64.   8   Don't set any packet limit for results and parameters.
  65.  16   Don't prompt for questions even if driver would like to prompt
  66.  32   Simulate a ODBC 1.0 driver in some context.
  67.  64   Ignore use of database name in 'database.table.column'. (MySQL 3.22)
  68. 128   Force use of ODBC manager cursors (experimental)
  69. 256   Remove use of extended fetch (experimental)
  70. 512   Pad CHAR fields to full column length.
  71. 1024  SQLDescribeCol() will return fully qualifed column names
  72. 2048  Use compressed protocol (if server supports it)
  73. 4096  Tell server to ignore space after function name and before '('
  74.       (needed by PowerBuilder).  This will make all function names keywords!
  75. 8192  Connect with named pipes to a mysqld server running on NT.
  76. 16384 Change LONGLONG columns to INT columns, as some applications can't
  77.       handle LONGLONG.
  78. 32768 Return 'user' as Table_qualifier and Table_owner from SQLTables
  79.       (test)
  80. 65536 Read my.cnf
  81. 131072 Add some extra safety checks (should not bee needed but...)
  82. 262144  Disable the new transaction support (To avoid newly introduced bugs)
  83.  
  84. On Unix; If you want to have many options, you should add the above flags!
  85. For example Option 12 (4+8) gives you debugging without package limits!
  86.  
  87. Some clients that must set some MySQL options to work properly.
  88. On Win32 one have to check the specific option in the ODBC manager
  89. for the database connection.
  90.  
  91.   BDE applications:    1 or 3;  'Don't optimize column widths' and
  92.                  'Return matching rows'
  93.   Visual Objects:    1     'Don't optimize column widths'
  94.   Vision        2     'Return matching rows' 
  95.   Active server pages   2     'Return matching rows'
  96.   Access 7.0:        2     'Return matching rows'
  97.   Access 2.0:        2+32     'Return matching rows' and 'Simulate ODBC 1.0'
  98.   ODBCETE32 + quiktest  512+1     'Don't optimize column widths' + 'Pad CHAR'
  99.   Visual Basic / ADO     2+16384  ''Return matching rows / BIGINT -> INT' 
  100.  
  101. The default MYODBC.DLL is compiled for optimal performance.  If you
  102. want to to debug MyODBC (for example to enable tracing), you should
  103. instead use the the MYODBCD.DLL.  If you want to use this one, copy
  104. MYODBCD.DLL over the installed MYODBC.DLL.
  105.  
  106. If you have any problems with MyODBC, try first to get the 'admndemo'
  107. program, that is include with the MyODBC distribution, to work!
  108.  
  109. Some common problems:
  110.  
  111. - Wrong connection port:  The port should be 3333 for MySQL 3.20 and 3306
  112.   (default) for MySQL 3.21 or newer.
  113. - Access denied problems.  Check the MySQL reference manual for information
  114.   about the MySQL privilege system!
  115. - If you are connecting to a server with a character set that isn't compiled
  116.   into the MySQL client library (the defaults are:
  117.   latin1 big5 czech euc_kr gb2312 gbk sjis tis620 ujis
  118.   ) then you need to install the mysql character definitions from the
  119.   charsets directory into the c:\mysql\share\charsets.
  120.  
  121.  
  122. Authors:
  123.  
  124. Main coding: Michael 'Monty' Widenius, TCX Datakonsult AB / MySQL AB
  125.  
  126. Known bugs:
  127.  
  128. - Access can't use float fields in a table without a timestamp if you are going
  129.   to update it. Double on the other hand should work.
  130. - Access 2000 needs a patch from Microsoft to be able to export tables to
  131.   MySQL;  Just download and install the newest Microsoft MDAC from
  132.   http://www.microsoft.com/data
  133. - There is a bug in the Microsoft ODBC setup that it can't detect if a OS
  134.   is NT or WIN95.  Because of this MyODBC is distributed in 2 different
  135.   versions, one for WIN95 and one for NT.
  136.   The only difference is the file odbc.inf, which tells SETUP if it should
  137.   install CTL3D95.DL_ or CTL3DNT.DLL as CTL3D32.DLL.
  138.   If you have downloaded wrong version of MyODBC simple copy ODBC.95 or ODBC.NT
  139.   over ODBC.INF and execute setup again!
  140. - ODBC 2.50 doesn't allow very good usage of bigint (64 bit) numbers; some
  141.   applications may have a problem with this.
  142. - TIMESTAMP to TIME conversions doesn't work.
  143. - Binary fields are returned as strings, not as hex strings.
  144. - Some conversion are not according to the ODBC standard, but this shouldn't
  145.   affect standard applications.
  146. - Some applications thinks that MyODBC has full cursor support.  This is not
  147.   true (we are working on this however);  If your application need full cursor
  148.   support you should tell your application to use the ODBC manager cursor
  149.   library.
  150. - As MyODBC doesn't yet have an own cursor library one can only use MyODBC
  151.   with applications that follows the ODBC specification and can work with
  152.   ODBC MANAGER cursors. Some programs, notably from Microsoft, doesn't
  153.   follow the ODBC specification how to use cursors;  They only work with
  154.   DRIVER cursors!  There may be a change that you can fool the application
  155.   to use MANAGER cursors by using the 128 option flag!
  156.   There is work in progress in supporting cursors in MyODBC.  If you are
  157.   interested in helping us with this, mail what you can do to myodbc@mysql.com
  158.   You can also support our work by taking MySQL email support!
  159. - ODBC can't support zero dates "0000-00-00". MyODBC automaticly converts
  160.   0000-00-00 dates to NULL.  Date columns that you want to update and that
  161.   can be 0000-00-00 should not be declared as 'NOT NULL'.
  162. - One should add a help to the connect screen.
  163.